Jenkins-cli 自动化构建工具（1）

Jenkins
Build Status
Build Status

这是一个 Node Jenkins 客户端.

API 接口文档列表

<a name="promise"></a>

Promise

在 Node 高版本中可以通过设置 promisify 为 true 打开支持，更老版本可以通过包装器(例如 bluebird.fromCallback)完成

<a name="common-options"></a>

通用选项

这些选项会在每次调用时生效，但并非所有 Jenkins 服务端都支持

  • depth (Number, default: 0): 返回数据量控制 (参考 设置 depth 参数)
  • tree (String, optional): 路径描述符 (参考 Jenkins 官方 API )

<a name="init"></a>

jenkins([options])

初始化一个 Jenkins 客户端

选项

  • baseUrl (String): Jenkins 服务器 URL
  • crumbIssuer (Boolean, default: false): 开启 CSRF 保护
  • headers (Object, optional): 每次请求头部的设定
  • promisify (Boolean|Function, optional): 将回调转为 Promise

用法

var jenkins = require('jenkins')({ baseUrl: 'http://user:pass@localhost:8080', crumbIssuer: true });

<a name="info"></a>

jenkins.info(callback)

获取 Jenkins 服务端信息

用法

jenkins.info(function(err, data) {
  if (err) throw err;

  console.log('info', data);
});

样例输出

{
  "assignedLabels": [
    {}
  ],
  "description": null,
  "jobs": [
    {
      "color": "blue",
      "name": "example",
      "url": "http://localhost:8080/job/example/"
    }
  ],
  "mode": "NORMAL",
  "nodeDescription": "the master Jenkins node",
  "nodeName": "",
  "numExecutors": 2,
  "overallLoad": {},
  "primaryView": {
    "name": "All",
    "url": "http://localhost:8080/"
  },
  "quietingDown": false,
  "slaveAgentPort": 12345,
  "unlabeledLoad": {},
  "useCrumbs": false,
  "useSecurity": false,
  "views": [
    {
      "name": "All",
      "url": "http://localhost:8080/"
    }
  ]
}

<a name="build-get"></a>

jenkins.build.get(options, callback)

获取构建信息

传参

  • name (String): 任务名称
  • number (Integer): 构建编号

用法

jenkins.build.get('example', 1, function(err, data) {
  if (err) throw err;

  console.log('build', data);
});

样例输出

{
  "actions": [],
  "buildable": true,
  "builds": [
    {
      "number": 1,
      "url": "http://localhost:8080/job/example/1/"
    }
  ],
  "color": "blue",
  "concurrentBuild": false,
  "description": "",
  "displayName": "example",
  "displayNameOrNull": null,
  "downstreamProjects": [],
  "firstBuild": {
    "number": 1,
    "url": "http://localhost:8080/job/example/1/"
  },
  "healthReport": [
    {
      "description": "Build stability: No recent builds failed.",
      "iconUrl": "health-80plus.png",
      "score": 100
    }
  ],
  "inQueue": false,
  "keepDependencies": false,
  "lastBuild": {
    "number": 1,
    "url": "http://localhost:8080/job/example/1/"
  },
  "lastCompletedBuild": {
    "number": 1,
    "url": "http://localhost:8080/job/example/1/"
  },
  "lastFailedBuild": null,
  "lastStableBuild": {
    "number": 1,
    "url": "http://localhost:8080/job/example/1/"
  },
  "lastSuccessfulBuild": {
    "number": 1,
    "url": "http://localhost:8080/job/example/1/"
  },
  "lastUnstableBuild": null,
  "lastUnsuccessfulBuild": null,
  "name": "example",
  "nextBuildNumber": 2,
  "property": [],
  "queueItem": null,
  "scm": {},
  "upstreamProjects": [],
  "url": "http://localhost:8080/job/example/"
}

<a name="build-log"></a>

jenkins.build.log(options, callback)

获取构建日志

传参

  • name (String): 任务名称
  • number (Integer): 构建编号
  • start (Integer, 可选): start offset
  • type (String, enum: text, html, 默认: text): 指定输出类型
  • meta (Boolean, default: false): return object with text (log data), more (boolean if there is more log data), and size (used with start to offset on subsequent calls)

用法

jenkins.build.log('example', 1, function(err, data) {
  if (err) throw err;

  console.log('log', data);
});

<a name="build-log-stream"></a>

jenkins.build.logStream(options, callback)

获取构建日志流

传参

  • name (String): 任务名称
  • number (Integer): 构建编号
  • type (String, enum: text, html, default: text): 指定输出类型
  • delay (Integer, default: 1000): poll interval in milliseconds

用法

var log = jenkins.build.logStream('example', 1);

log.on('data', function(text) {
  process.stdout.write(text);
});

log.on('error', function(err) {
  console.log('error', err);
});

log.on('end', function() {
  console.log('end');
});

<a name="build-stop"></a>

jenkins.build.stop(options, callback)

中断构建

传参

  • name (String): 任务名称
  • number (Integer): 构建编号

用法

jenkins.build.stop('example', 1, function(err) {
  if (err) throw err;
});

<a name="job-build"></a>

jenkins.job.build(options, callback)

开始构建

传参

  • name (String): 任务名称
  • parameters (Object, 可选): 构建参数
  • token (String, 可选): 鉴权标识

用法

jenkins.job.build('example', function(err, data) {
  if (err) throw err;

  console.log('queue item number', data);
});

jenkins.job.build({ name: 'example', parameters: { name: 'value' } }, function(err) {
  if (err) throw err;
});

<a name="job-config-get"></a>

jenkins.job.config(options, callback)

获取任务配置（XML形式）

传参

  • name (String): 任务名称

用法

jenkins.job.config('example', function(err, data) {
  if (err) throw err;

  console.log('xml', data);
});

<a name="job-config-set"></a>

jenkins.job.config(options, callback)

修改任务配置（XML形式）

传参

  • name (String): 任务名称
  • xml (String): 配置文件

用法

jenkins.job.config('example', xml, function(err) {
  if (err) throw err;
});

<a name="job-config-copy"></a>

jenkins.job.copy(options, callback)

从已有的项目中克隆新的任务

传参

  • name (String): 新任务名称
  • from (String): 源任务名称

用法

jenkins.job.copy('fromJob', 'example', function(err) {
  if (err) throw err;
});

<a name="job-create"></a>

jenkins.job.create(options, callback)

从配置文件创建新的任务

传参

  • name (String): 任务名称
  • xml (String): 配置文件

用法

jenkins.job.create('example', xml, function(err) {
  if (err) throw err;
});

<a name="job-destroy"></a>

jenkins.job.destroy(options, callback)

删除任务

传参

  • name (String): 任务名称

用法

jenkins.job.destroy('example', function(err) {
  if (err) throw err;
});

<a name="job-disable"></a>

jenkins.job.disable(options, callback)

停用一个任务

传参

  • name (String): 任务名称

用法

jenkins.job.disable('example', function(err) {
  if (err) throw err;
});

<a name="job-enable"></a>

jenkins.job.enable(options, callback)

启动一个任务

传参

  • name (String): 任务名称

用法

jenkins.job.enable('example', function(err) {
  if (err) throw err;
});

<a name="job-exists"></a>

jenkins.job.exists(options, callback)

监测任务是否存在

传参

  • name (String): 任务名称

用法

jenkins.job.exists('example', function(err, exists) {
  if (err) throw err;

  console.log('exists', exists);
});

<a name="job-get"></a>

jenkins.job.get(options, callback)

获取任务信息，得到 json 格式配置文件

传参

  • name (String): 任务名称

用法

jenkins.job.get('example', function(err, data) {
  if (err) throw err;

  console.log('job', data);
});

样例输出

{
  "actions": [],
  "buildable": true,
  "builds": [
    {
      "number": 1,
      "url": "http://localhost:8080/job/example/1/"
    }
  ],
  "color": "blue",
  "concurrentBuild": false,
  "description": "",
  "displayName": "example",
  "displayNameOrNull": null,
  "downstreamProjects": [],
  "firstBuild": {
    "number": 1,
    "url": "http://localhost:8080/job/example/1/"
  },
  "healthReport": [
    {
      "description": "Build stability: No recent builds failed.",
      "iconUrl": "health-80plus.png",
      "score": 100
    }
  ],
  "inQueue": false,
  "keepDependencies": false,
  "lastBuild": {
    "number": 1,
    "url": "http://localhost:8080/job/example/1/"
  },
  "lastCompletedBuild": {
    "number": 1,
    "url": "http://localhost:8080/job/example/1/"
  },
  "lastFailedBuild": null,
  "lastStableBuild": {
    "number": 1,
    "url": "http://localhost:8080/job/example/1/"
  },
  "lastSuccessfulBuild": {
    "number": 1,
    "url": "http://localhost:8080/job/example/1/"
  },
  "lastUnstableBuild": null,
  "lastUnsuccessfulBuild": null,
  "name": "example",
  "nextBuildNumber": 2,
  "property": [],
  "queueItem": null,
  "scm": {},
  "upstreamProjects": [],
  "url": "http://localhost:8080/job/example/"
}

<a name="job-list"></a>

jenkins.job.list(callback)

列出所有的任务

用法

jenkins.job.list(function(err, data) {
  if (err) throw err;

  console.log('jobs', data);
});

样例输出

[
  {
    "color": "blue",
    "name": "example",
    "url": "http://localhost:8080/job/example/"
  }
]

<a name="node-config-get"></a>

jenkins.node.config(options, callback)

获取节点配置信息（XML 形式）

传参

  • name (String): 节点名称

用法

jenkins.node.config('example', function(err, data) {
  if (err) throw err;

  console.log('xml', data);
});

<a name="node-create"></a>

jenkins.node.create(options, callback)

创建一个新的节点

传参

  • name (String): 节点名称

用法

jenkins.node.create('slave', function(err) {
  if (err) throw err;
});

<a name="node-destroy"></a>

jenkins.node.destroy(options, callback)

删除节点

传参

  • name (String): 节点名称

用法

jenkins.node.destroy('slave', function(err) {
  if (err) throw err;
});

<a name="node-disconnect"></a>

jenkins.node.disconnect(options, callback)

断开与指定节点的链接

传参

  • name (String): 节点名称
  • message (String, optional): reason for being disconnected

用法

jenkins.node.disconnect('slave', 'no longer used', function(err) {
  if (err) throw err;
});

<a name="node-disable"></a>

jenkins.node.disable(options, callback)

停用一个节点

传参

  • name (String): 节点名称
  • message (String, optional): reason for being disabled

用法

jenkins.node.disable('slave', 'network failure', function(err) {
  if (err) throw err;
});

<a name="node-enable"></a>

jenkins.node.enable(options, callback)

启用一个节点

传参

  • name (String): 节点名称

用法

jenkins.node.enable('slave', function(err) {
  if (err) throw err;
});

<a name="node-exists"></a>

jenkins.node.exists(options, callback)

检查节点是否存在

传参

  • name (String): 节点名称

用法

jenkins.node.exists('slave', function(err, exists) {
  if (err) throw err;

  console.log('exists', exists);
});

<a name="node-get"></a>

jenkins.node.get(options, callback)

获取节点信息

传参

  • name (String): 节点名称

用法

jenkins.node.get('slave', function(err, data) {
  if (err) throw err;

  console.log('node', data);
});

样例输出

{
  "actions": [],
  "displayName": "slave",
  "executors": [
    {},
    {}
  ],
  "icon": "computer-x.png",
  "idle": true,
  "jnlpAgent": true,
  "launchSupported": false,
  "loadStatistics": {},
  "manualLaunchAllowed": true,
  "monitorData": {
    "hudson.node_monitors.ArchitectureMonitor": null,
    "hudson.node_monitors.ClockMonitor": null,
    "hudson.node_monitors.DiskSpaceMonitor": null,
    "hudson.node_monitors.ResponseTimeMonitor": {
      "average": 5000
    },
    "hudson.node_monitors.SwapSpaceMonitor": null,
    "hudson.node_monitors.TemporarySpaceMonitor": null
  },
  "numExecutors": 2,
  "offline": true,
  "offlineCause": null,
  "offlineCauseReason": "",
  "oneOffExecutors": [],
  "temporarilyOffline": false
}

<a name="node-list"></a>

jenkins.node.list(callback)

列出所有可用节点

传参

  • full (Boolean, default: false): 包含节点的执行次数

用法

jenkins.node.list(function(err, data) {
  if (err) throw err;

  console.log('nodes', data);
});

样例输出

{
  "busyExecutors": 0,
  "computer": [
    {
      "actions": [],
      "displayName": "master",
      "executors": [
        {},
        {}
      ],
      "icon": "computer.png",
      "idle": true,
      "jnlpAgent": false,
      "launchSupported": true,
      "loadStatistics": {},
      "manualLaunchAllowed": true,
      "monitorData": {
        "hudson.node_monitors.ArchitectureMonitor": "Linux (amd64)",
        "hudson.node_monitors.ClockMonitor": {
          "diff": 0
        },
        "hudson.node_monitors.DiskSpaceMonitor": {
          "path": "/var/lib/jenkins",
          "size": 77620142080
        },
        "hudson.node_monitors.ResponseTimeMonitor": {
          "average": 0
        },
        "hudson.node_monitors.SwapSpaceMonitor": {
          "availablePhysicalMemory": 22761472,
          "availableSwapSpace": 794497024,
          "totalPhysicalMemory": 515358720,
          "totalSwapSpace": 805302272
        },
        "hudson.node_monitors.TemporarySpaceMonitor": {
          "path": "/tmp",
          "size": 77620142080
        }
      },
      "numExecutors": 2,
      "offline": false,
      "offlineCause": null,
      "offlineCauseReason": "",
      "oneOffExecutors": [],
      "temporarilyOffline": false
    },
    {
      "actions": [],
      "displayName": "slave",
      "executors": [
        {},
        {}
      ],
      "icon": "computer-x.png",
      "idle": true,
      "jnlpAgent": true,
      "launchSupported": false,
      "loadStatistics": {},
      "manualLaunchAllowed": true,
      "monitorData": {
        "hudson.node_monitors.ArchitectureMonitor": null,
        "hudson.node_monitors.ClockMonitor": null,
        "hudson.node_monitors.DiskSpaceMonitor": null,
        "hudson.node_monitors.ResponseTimeMonitor": {
          "average": 5000
        },
        "hudson.node_monitors.SwapSpaceMonitor": null,
        "hudson.node_monitors.TemporarySpaceMonitor": null
      },
      "numExecutors": 2,
      "offline": true,
      "offlineCause": null,
      "offlineCauseReason": "",
      "oneOffExecutors": [],
      "temporarilyOffline": false
    }
  ],
  "displayName": "nodes",
  "totalExecutors": 2
}

<a name="queue-list"></a>

jenkins.queue.list(callback)

列出节点中当前任务列表

用法

jenkins.queue.list(function(err, data) {
  if (err) throw err;

  console.log('queues', data);
});

样例输出

{
  "items": [
    {
      "actions": [
        {
          "causes": [
            {
              "shortDescription": "Started by user anonymous",
              "userId": null,
              "userName": "anonymous"
            }
          ]
        }
      ],
      "blocked": true,
      "buildable": false,
      "buildableStartMilliseconds": 1389418977387,
      "id": 20,
      "inQueueSince": 1389418977358,
      "params": "",
      "stuck": false,
      "task": {
        "color": "blue_anime",
        "name": "example",
        "url": "http://localhost:8080/job/example/"
      },
      "url": "queue/item/20/",
      "why": "Build #2 is already in progress (ETA:N/A)"
    }
  ]
}

<a name="queue-item"></a>

jenkins.queue.item(options, callback)

查看任务列表中的项目

传参

  • number (Integer): 任务列表周某项的 ID

用法

jenkins.queue.item(130, function(err, data) {
  if (err) throw err;

  console.log('item', data);
});

样例输出

{
  "actions": [
    {
      "causes": [
        {
          "shortDescription": "Started by user anonymous",
          "userId": null,
          "userName": "anonymous"
        }
      ]
    }
  ],
  "blocked": false,
  "buildable": false,
  "id": 130,
  "inQueueSince": 1406363479853,
  "params": "",
  "stuck": false,
  "task": {
    "name": "test-job-b7ef0845-6515-444c-96a1-d2266d5e0f18",
    "url": "http://localhost:8080/job/test-job-b7ef0845-6515-444c-96a1-d2266d5e0f18/",
    "color": "blue"
  },
  "url": "queue/item/130/",
  "why": null,
  "executable" : {
    "number" : 28,
    "url" : "http://localhost:8080/job/test-job-b7ef0845-6515-444c-96a1-d2266d5e0f18/28/"
  }
}

<a name="queue-cancel"></a>

jenkins.queue.cancel(options, callback)

将执行队列中某一项停掉

传参

  • number (Integer): 任务列表周某项的 ID

用法

jenkins.queue.cancel(23, function(err) {
  if (err) throw err;
});

<a name="view-config-get"></a>

jenkins.view.config(options, callback)

获取视图的配置（XML 形式）

传参

  • name (String): 任务名称

用法

jenkins.view.config('example', function(err, data) {
  if (err) throw err;

  console.log('xml', data);
});

<a name="view-config-set"></a>

jenkins.job.config(options, callback)

更新视图配置（XML 形式）

传参

  • name (String): 任务名称
  • xml (String): 配置文件

用法

jenkins.view.config('example', xml, function(err) {
  if (err) throw err;
});

<a name="view-create"></a>

jenkins.view.create(options, callback)

创建视图

传参

  • name (String): 视图名称
  • type (String, enum: list, my): 视图类型

用法

jenkins.view.create('example', 'list', function(err) {
  if (err) throw err;
});

<a name="view-destroy"></a>

jenkins.view.destroy(options, callback)

删除视图

传参

  • name (String): view name

用法

jenkins.view.destroy('example', function(err) {
  if (err) throw err;
});

<a name="view-exists"></a>

jenkins.view.exists(options, callback)

检查视图是否存在

传参

  • name (String): view name

用法

jenkins.view.exists('example', function(err, exists) {
  if (err) throw err;

  console.log('exists', exists);
});

<a name="view-get"></a>

jenkins.view.get(options, callback)

获取视图信息，json 返回

传参

  • name (String): view name

用法

jenkins.view.get('example', function(err, data) {
  if (err) throw err;

  console.log('view', data);
});

样例输出

{
  "description": null,
  "jobs": [
    {
      "name": "test",
      "url": "http://localhost:8080/job/example/",
      "color": "blue"
    }
  ],
  "name": "example",
  "property": [],
  "url": "http://localhost:8080/view/example/"
}

<a name="view-list"></a>

jenkins.view.list(callback)

列出所有视图

用法

jenkins.view.list(function(err, data) {
  if (err) throw err;

  console.log('views', data);
});

样例输出

{
  "views": [
    {
      "url": "http://localhost:8080/",
      "name": "All"
    },
    {
      "url": "http://localhost:8080/view/example/",
      "name": "Test"
    }
  ],
  "useSecurity": false,
  "useCrumbs": false,
  "unlabeledLoad": {},
  "slaveAgentPort": 0,
  "quietingDown": false,
  "primaryView": {
    "url": "http://localhost:8080/",
    "name": "All"
  },
  "assignedLabels": [
    {}
  ],
  "mode": "NORMAL",
  "nodeDescription": "the master Jenkins node",
  "nodeName": "",
  "numExecutors": 2,
  "description": null,
  "jobs": [
    {
      "color": "notbuilt",
      "url": "http://localhost:8080/job/example/",
      "name": "test"
    }
  ],
  "overallLoad": {}
}

<a name="view-add"></a>

jenkins.view.add(options, callback)

将任务添加到视图

传参

  • name (String): 视图名称
  • job (String): 任务名称

用法

jenkins.view.add('example', 'jobExample', function(err) {
  if (err) throw err;
});

<a name="view-remove"></a>

jenkins.view.remove(options, callback)

将任务移除视图

传参

  • name (String): 视图名称
  • job (String): 任务名称

用法

jenkins.view.remove('example', 'jobExample', function(err) {
  if (err) throw err;
});

License

本项目遵循 MIT License (see the LICENSE file).

Notes

python-jenkins (BSD License, see NOTES)
为本项目提供了大量思路。

最后编辑于 ：
©著作权归作者所有,转载或内容合作请联系作者
  • 人面猴
    序言：七十年代末，一起剥皮案震惊了整个滨河市，随后出现的几起案子，更是在滨河造成了极大的恐慌，老刑警刘岩，带你破解...
    沈念sama阅读 159,569评论 4赞 363
  • 死咒
    序言：滨河连续发生了三起死亡事件，死亡现场离奇诡异，居然都是意外死亡，警方通过查阅死者的电脑和手机，发现死者居然都...
    沈念sama阅读 67,499评论 1赞 294
  • 救了他两次的神仙让他今天三更去死
    文/潘晓璐 我一进店门，熙熙楼的掌柜王于贵愁眉苦脸地迎上来，“玉大人，你说我怎么就摊上这事。” “怎么了？”我有些...
    开封第一讲书人阅读 109,271评论 0赞 244
  • 道士缉凶录：失踪的卖姜人
    文/不坏的土叔 我叫张陵，是天一观的道长。 经常有香客问我，道长，这世上最难降的妖魔是什么？ 我笑而不...
    开封第一讲书人阅读 44,087评论 0赞 209
  • 港岛之恋（遗憾婚礼）
    正文 为了忘掉前任，我火速办了婚礼，结果婚礼上，老公的妹妹穿的比我还像新娘。我一直安慰自己，他们只是感情好，可当我...
    茶点故事阅读 52,474评论 3赞 287
  • 恶毒庶女顶嫁案：这布局不是一般人想出来的
    文/花漫 我一把揭开白布。 她就那样静静地躺着，像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上，一...
    开封第一讲书人阅读 40,670评论 1赞 222
  • 城市分裂传说
    那天，我揣着相机与录音，去河边找鬼。 笑死，一个胖子当着我的面吹牛，可吹牛的内容都是我干的。 我是一名探鬼主播，决...
    沈念sama阅读 31,911评论 2赞 313
  • 双鸳鸯连环套：你想象不到人心有多黑
    文/苍兰香墨 我猛地睁开眼，长吁一口气：“原来是场噩梦啊……” “哼！你这毒妇竟也来了？” 一声冷哼从身侧响起，我...
    开封第一讲书人阅读 30,636评论 0赞 202
  • 万荣杀人案实录
    序言：老挝万荣一对情侣失踪，失踪者是张志新（化名）和其女友刘颖，没想到半个月后，有当地人在树林里发现了一具尸体，经...
    沈念sama阅读 34,397评论 1赞 246
  • 护林员之死
    正文 独居荒郊野岭守林人离奇死亡，尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,607评论 2赞 246
  • 白月光启示录
    正文 我和宋清朗相恋三年，在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 32,093评论 1赞 261
  • 活死人
    序言：一个原本活蹦乱跳的男人离奇死亡，死状恐怖，灵堂内的尸体忽然破棺而出，到底是诈尸还是另有隐情，我是刑警宁泽，带...
    沈念sama阅读 28,418评论 2赞 254
  • 日本核电站爆炸内幕
    正文 年R本政府宣布，位于F岛的核电站，受9级特大地震影响，放射性物质发生泄漏。R本人自食恶果不足惜，却给世界环境...
    茶点故事阅读 33,074评论 3赞 237
  • 男人毒药：我在死后第九天来索命
    文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹，春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,092评论 0赞 8
  • 一桩弑父案，背后竟有这般阴谋
    文/苍兰香墨 我抬头看了看天上的太阳。三九已至，却和暖如春，着一层夹袄步出监牢的瞬间，已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,865评论 0赞 196
  • 情欲美人皮
    我被黑心中介骗来泰国打工， 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留，地道东北人。 一个月前我还...
    沈念sama阅读 35,726评论 2赞 276
  • 代替公主和亲
    正文 我出身青楼，却偏偏与公主长得像，于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子，可洞房花烛夜当晚...
    茶点故事阅读 35,627评论 2赞 270

推荐阅读更多精彩内容